home *** CD-ROM | disk | FTP | other *** search
/ Power CD / Power CD ATARI-Rechner Lieben.iso / UTILITY / TRASH / TRASH.TXT < prev   
Encoding:
Text File  |  1992-12-29  |  19.8 KB  |  457 lines

  1.                             TRASH.CPX
  2.  
  3.                          Version  01.05
  4.  
  5.               CPX-Modul der Utility-Serie von mz'91
  6.  
  7.  
  8.  
  9.  
  10. 1. Einleitung
  11.  
  12. TRASH.CPX  ist ein nachladbares Modul für das modulare  Kontroll-
  13. feld XCONTROL von Atari.
  14. Es  ermöglicht die Konfiguration eines residenten  Treibers,  der 
  15. den Papierkorb des Desktop 'leerbar' macht,  also die  Restaurie-
  16. rung  gelöschter Dateien ermöglicht.
  17. TRASH.CPX  ist ein CPX-Modul der Utility-Serie von  mz'91.  Diese 
  18. CPX-Module ermöglichen die Konfiguration der System-Hardware  und 
  19. -Software  und im Zusammenspiel mit residenten Programmen  einige 
  20. nützliche Zusatzfunktionen.
  21. Die  CPX-Module der Utility-Serie sind für den Einsatz auf  Atari 
  22. ST-Modellen  geschrieben.  Auf anderen Atari-Rechnern wurden  sie 
  23. nicht  getestet.  Einige  Funktionen  sind  von  der  TOS-Version 
  24. abhängig.
  25.  
  26. Zur Zeit sind folgende CPX-Module verfügbar:
  27.  
  28.      DIVERSES.CPX   V01.12 (1)  -Uhrzeiteinblendung, Alarmzeit,                              
  29.                                  Drucker-Code-Konverter,
  30.                                  Bildwiederholfrequenzeinstellung
  31.  
  32.      DISK.CPX       V01.02 (2)  -Steprateneinstellung Laufwerke A
  33.                                  und B, Floppy-Write-Verify-Wahl,
  34.                                  HD-Parken mittels externem PRG
  35.  
  36.      TRASH.CPX      V01.05      -Installation eines 'leerbaren
  37.                                  Papierkorbs'
  38.  
  39.      DESKPIC.CPX    V01.14 (3)  -Anzeige eines Desktop-Hintergrund-
  40.                                  Bildes im DEGAS-Format
  41.  
  42.  
  43.  
  44. (1) Uhrfunktion nur für TOS 1.04 oder Hardwareuhr;
  45.     Frequenzeinstellung nur für ST
  46. (2) HD-Parkfunktion nur für reine TOS-Programme geeignet
  47. (3) nur für hohe ST-Auflösung (640x400 monochrom)
  48.  
  49. Bezug und Information:
  50.  
  51.      Michael Zuhl
  52.      Transvaalstr. 16
  53.      1000 Berlin 65
  54.  
  55.  
  56. 2. Übersicht über die mitgelieferten Dateien
  57.  
  58.      TRASH.CPX ........ CPX-Modul für XCONTROL
  59.      TRASH.PRG ........ residente Treiber für Papierkorb
  60.      TRASH.DOC ........ diese Anleitung (WP-Format)
  61.      TRASH.TXT ........ diese Anleitung (ASCII-Format)
  62.  
  63.  
  64. 2.1 Beschreibung von TRASH.CPX
  65.  
  66. TRASH.CPX  ist ein nachladbares Modul für das modulare  Kontroll-
  67. feld  XCONTROL  von Atari.  Es ermöglicht die  Konfiguration  des 
  68. mitgelieferten  residenten  Treibers für die  Installation  eines 
  69. 'leerbaren' Papierkorbs.
  70. TRASH.CPX sollte im gleichen Verzeichnis abgelegt werden wie  die 
  71. übrigen  CPX-Module,  damit  es beim Booten von XCONTROL  in  die 
  72. Liste der verfügbaren CPX-Module übernommen werden kann.
  73. TRASH.CPX  arbeitet  nur  im  Zusammenspiel  mit  dem  residenten 
  74. Programm TRASH.PRG (s. dort).
  75. TRASH.CPX  ist ein CPX-Modul der Utility-Serie von mz'91 und  als 
  76. solches  frei kopierbar.  Es sollte sinnvollerweise nur  mit  dem 
  77. Programm TRASH.PRG und dieser Anleitung weitergegeben werden. Die 
  78. CPX-Module  der Utility-Serie sind für den Gebrauch mit  XCONTROL 
  79. von Atari auf ST-Systemen konzipiert.  Damit unterliegen sie  den 
  80. Einschränkungen  und Besonderheiten,  die Atari in der  XCONTROL-
  81. Dokumentation aufgeführt hat (s.  dort).  Insbesondere stürzt der 
  82. Rechner regelmäßig ab, wenn im Farbbetrieb die Auflösung geändert 
  83. und  anschließend im Löschdialog eine Scroll-Funktion  aufgerufen 
  84. wird,  und  zwar  unabhängig  davon,  ob  zuvor  (wie  von  Atari 
  85. empfohlen)  XCONTROL abgeschaltet wurde oder nicht.  Die  Ursache 
  86. dieses Verhaltens konnte ich trotz intensiver Suche nicht  eruie-
  87. ren; daher muß von einem Wechsel der Auflösung bei Verwendung von 
  88. TRASH.CPX / TRASH.PRG abgeraten werden (oder umgekehrt).  Da  die 
  89. Farbdarstellung aber zum vernünftigen Arbeiten ohnehin ungeeignet 
  90. ist, dürfte diese Einschränkung nicht ins Gewicht fallen.
  91.  
  92.  
  93. 2.2 Beschreibung von TRASH.PRG
  94.  
  95. TRASH.PRG ist ein residentes Programm,  das einen Treiber für die 
  96. Benutzung des Desktop-Papierkorbs als 'leerbaren' Papierkorb  zur 
  97. Verfügung stellt,  also die Möglichkeit bietet, gelöschte Dateien 
  98. wieder  zu restaurieren.  Resident bedeutet,  daß sich  TRASH.PRG 
  99. beim Booten in das Betriebssystem einklinkt und bis zum  nächsten 
  100. Reset bzw.  Ausschalten im Speicher verbleibt. Wegen des geringen 
  101. Speicherbedarfs ist dies auch in Systemen mit geringem  Speicher-
  102. ausbau nicht problematisch.
  103. TRASH.PRG  sollte  wie alle residenten Programme  aus  dem  AUTO-
  104. Ordner heraus beim Booten des Systems gestartet werden; da es auf 
  105. den Zeitpunkt des Starts aber nicht ankommt,  ist (nach  Umbenen-
  106. nung in TRASH.TOS) auch ein Start vom Desktop aus möglich.  Unter 
  107. der  Betriebssystemerweiterung  MiNT  muß  TRASH.PRG  nach   MiNT 
  108. gestartet werden, also z.B. aus MINT.CNF heraus.
  109. 2.3 Beschreibung von TRASH.DOC und TRASH.TXT
  110.  
  111. TRASH.DOC und TRASH.TXT enthalten jeweils diesen Anleitungstext.
  112. TRASH.DOC liegt im WP-Format vor.  Somit kann der Text mit  allen 
  113. Programmen,  die  das WORDPLUS-Datei-Format  verarbeiten  können, 
  114. gelesen und ausgedruckt werden.
  115. TRASH.TXT  enthält  den Text als reine  ASCII-Datei  ohne  Forma-
  116. tierungscodes.  Dieser  Text  kann daher mit  ASCII-Editoren  und 
  117. direkt vom Desktop aus gelesen und ausgedruckt werden.
  118.  
  119.  
  120. 3. Bedienungsanleitung
  121.  
  122. 3.1 Bedienung von TRASH.CPX
  123.  
  124. TRASH.CPX  wird genauso bedient wie die von Atari  mitgelieferten 
  125. CPX-Module.  In der Modul-Liste von XCONTROL trägt es sich  unter 
  126. der Bezeichnung 'Trash Utility' ein.
  127. Die Funktionen von TRASH.CPX sind auf zwei Dialogboxen verteilt:
  128.  
  129.      Hauptdialog ........... Einstellen der Parameter
  130.      Löschdialog ........... Löschen der Dateien im TrashDir
  131.  
  132.  
  133. 3.1.1 TRASH.CPX: Bedienung Hauptdialog
  134.  
  135. Die  Bedienungselemente  des Hauptdialogs von TRASH.CPX  sind  in 
  136. fünf Funktionsgruppen unterteilt:
  137.  
  138.      Papierkorb-Funktion ... Wahl der Papierkorbfunktion
  139.      TrashDir-Ordner ....... Einstellen des TrashDir-Ordners
  140.      Lösch-Icon ............ Übergang zum Löschdialog
  141.      Information ........... Information über das CPX-Modul
  142.      Status-Funktionen ..... Speichern/Übernahme von Änderungen
  143.  
  144.  
  145. 3.1.1.1 TRASH.CPX: Hauptdialog / Papierkorb-Funktion
  146.  
  147. Klickt  man  den  Auswahlknopf  für  die  Papierkorbfunktion  an, 
  148. erscheint  ein  Popup-Menü mit den  Einträgen  'verschieben'  und 
  149. 'vernichten'. Wird 'verschieben' ausgewählt, wird eine Datei, die 
  150. auf  des  Papierkorb-Icon  des Desktop  gezogen  oder  von  einem 
  151. Programm per Betriebssystemaufruf gelöscht wird,  in das TrashDir 
  152. (s.  dort)  verschoben und nicht endgültig  gelöscht.  Gleichwohl 
  153. wird  sie an der ursprünglichen Stelle entfernt.  Man  kann  eine 
  154. solchermaßen  'verschobene' Datei also dadurch  wiederherstellen, 
  155. daß  man  sie aus dem TrashDir an eine  beliebige  andere  Stelle 
  156. zurückkopiert. Prinzipbedingt wird auch eine Kopie einer Datei im 
  157. TrashDir  angelegt,  die  mittels  des ab  TOS  1.04  verfügbaren 
  158. Desktop-Verschiebebefehls   (CONTROL-Taste   beim   Kopiervorgang 
  159. gedrückt halten) verschoben wurde; dies ist aber nicht schädlich, 
  160. das Verschieben wird vom Desktop korrekt ausgeführt.
  161. Klickt  man  'vernichten' an,  verhält sich  der  Papierkorb  wie 
  162. gewohnt:  Dateien,  die auf das Papierkorb-Icon gezogen oder  von 
  163. Programmen per Betriebssystemaufruf gelöscht werden,  werden  un-
  164. widerruflich gelöscht.
  165.  
  166.  
  167. 3.1.1.2 TRASH.CPX: Hauptdialog / TrashDir-Ordner
  168.  
  169. Im Feld TrashDir-Ordner wird der ausgewählte Ordner zur  Aufnahme 
  170. der verschobenen Dateien angezeigt.  Ist der Pfad länger als  das 
  171. Anzeigefeld kann mittels der Scroll-Knöpfe links und rechts neben 
  172. dem Anzeigefeld im Pfad gesrollt werden.  Hat der Pfad Überlänge, 
  173. wird  dies durch die Symbole '«' in der ersten bzw.  '»'  in  der 
  174. letzen Spalte angezeigt.
  175. Klickt man das Pfad-Anzeigefeld an,  erscheint eine Dateiauswahl-
  176. box.  Hier  kann ein neuer Ordner als TrashDir-Ordner  ausgewählt 
  177. werden.  Der  bisherige Ordner ist voreingestellt.  Wenn man  den 
  178. gewünschten Ordner erreicht hat,  klickt man den OK-Knopf an. Die 
  179. Auswahl  einer  bestimmten Datei hat  keinen  Einfluß.  Wird  der 
  180. ABBRUCH-Knopf angeklickt,  bleibt der alte TrashDir-Ordner erhal-
  181. ten.
  182. Es  ist bei ausreichendem Speicherausbau  eventuell  ratsam,  den 
  183. TrashDir-Ordner  auf  einer (vorzugsweise  resetfesten)  RAM-Disk 
  184. anzulegen;  damit  erspart  man sich beim Beenden der  Arbeit  am 
  185. Rechner  das Löschen der ins TrashDir verschobenen  Dateien,  die 
  186. man endgültig löschen möchte.
  187.  
  188.  
  189. 3.1.1.3 TRASH.CPX: Hauptdialog / Lösch-Icon
  190.  
  191. Wird  dieses Icon (unter links) angeklickt,  wechselt man in  den 
  192. Löschdialog,  in  dem man die ins TrashDir  verschobenen  Dateien 
  193. endgültig löschen kann (s. Bedienung Löschdialog).
  194.  
  195.  
  196. 3.1.1.4 TRASH.CPX: Information
  197.  
  198. Nach dem Anklicken des Informationsknopfes erscheint eine  Infor-
  199. mationsbox.  Mittels  Anklicken des OK-Knopfes oder  Drücken  der 
  200. RETURN-Taste gelangt man zurück zum Hauptdialog.
  201.  
  202.  
  203. 3.1.1.5 TRASH.CPX: Status-Funktionen
  204.  
  205. Diese  Funktionsgruppe befindet sich am unteren Rand der  Dialog-
  206. box. Sie besteht aus drei Auswahlknöpfen:
  207. SICHERN, OK und ABBRUCH.
  208. SICHERN  speichert  die  aktuellen  Funktionseinstellungen   nach 
  209. Rückfrage im CPX-Modul.  Dazu ist es erforderlich,  daß sich  das 
  210. CPX-Modul noch im CPX-Verzeichnis befindet.  Beim nächsten Booten 
  211. des  Systems werden dann alle Funktionen so eingestellt  wie  zum 
  212. Zeitpunkt des Sicherns.
  213. OK  übernimmt alle Funktionseinstellungen bis zum nächsten  Reset 
  214. bzw. Ausschalten des Systems. Das bedeutet, daß die Einstellungen 
  215. bis zum nächsten Reset bzw.  Ausschalten erhalten  bleiben,  beim 
  216. nächsten Booten jedoch wieder auf die zuletzt gespeicherten Werte 
  217. gesetzt werden.
  218. ABBRUCH  verwirft die vorgenommenen Änderungen der  Funktionsein-
  219. stellungen  und stellt den Zustand wieder her,  der  vorlag,  als 
  220. TRASH.CPX aufgerufen wurde.
  221. Das  Anklicken des Schließknopfes des  Kontrollfeldfensters  hat, 
  222. während  man sich im Hauptdialog befindet,  die Wirkung  von  OK; 
  223. befindet man sich im Löschdialog, hat es die Wirkung von ABBRUCH. 
  224. Zusätzlich wird das Kontrollfeldfenster geschlossen.
  225. Wenn   bei   geöffnetem  Kontrollfeldfenster   und   aufgerufenem 
  226. TRASH.CPX  die  laufende  Applikation beendet wird  hat  das  die 
  227. gleiche Wirkung wie ABBRUCH,  nur daß außerdem das  Kontrollfeld-
  228. fenster geschlossen wird.
  229.  
  230.  
  231. 3.1.2 TRASH.CPX: Bedienung Löschdialog
  232.  
  233. Die  Bedienungselemente  des Löschdialogs von TRASH.CPX  sind  in 
  234. drei Funktionsgruppen unterteilt:
  235.  
  236.      Löschfunktionen ....... Auslösen von Löschfunktionen
  237.      Dateiauswahl .......... Selektion der zu löschenden Dateien
  238.      Ausgang ............... Rückkehr zum Hauptdialog
  239.  
  240.  
  241. 3.1.2.1 TRASH.CPX: Löschdialog / Löschfunktionen
  242.  
  243. Diese Funktionsgruppe besteht aus zwei Knöpfen:
  244. 'selektiv' und 'alles'.
  245. Klickt  man  auf  den Knopf 'selektiv'  werden  alle  Dateien  im 
  246. TrashDir unwiderruflich gelöscht,  die zuvor im  Dateiauswahlfen-
  247. ster selektiert wurden (s. Löschdialog / Dateiauswahl). Ist keine 
  248. Datei im Auswahlfenster selektiert oder überhaupt keine Datei  im 
  249. TrashDir, ist der Knopf nicht anwählbar.
  250. Wird der Knopf 'alles' angeklickt, werden nach einer Sicherheits-
  251. abfrage   alle  Dateien  im  TrashDir  unwiderruflich   gelöscht. 
  252. Dateien,  die zuvor im Dateiauswahlfenster selektiert wurden  (s. 
  253. Löschdialog  / Dateiauswahl),  werden bei dieser  Funktion  NICHT 
  254. gelöscht.
  255.  
  256.  
  257. 3.1.2.2 TRASH.CPX: Löschdialog / Dateiauswahl
  258.  
  259. Im  Dateiauswahlfenster  können  einzelne  oder  mehrere  Dateien 
  260. selektiert  werden,  die endgültig gelöscht oder  nicht  gelöscht 
  261. werden sollen (s. Löschdialog / Löschfunktionen).
  262. Mittels  der Pfeile und des Schiebers rechts am Fensterrand  kann 
  263. im  TrashDir  wie  vom  Desktop-Dateiauswahlfenster  her  gewohnt 
  264. gescrollt  werden.  Dabei bleiben bereits getroffene  Selektionen 
  265. erhalten.
  266. Einzelne Dateien werden mittels Einfachklick auf ihren Eintrag im 
  267. Fenster  selektiert.  Bei einem erneuten Klickt auf eine  bereits 
  268. selektierte Datei wird diese deselektiert. Eine selektierte Datei 
  269. wird in invertierter Schrift angezeigt.
  270. Mehrere  Dateien kann man selektieren,  indem man  einen  Eintrag 
  271. anklickt und bei gedrückter Maustaste über andere Einträge fährt. 
  272. Berührt man dabei Einträge, die bereits selektiert waren, bleiben 
  273. diese  selektiert.  Fährt man bei gedrückter Maustaste nach  oben 
  274. oder  unten  aus  dem Fenster heraus und  gibt  es  noch  weitere 
  275. Dateien im TrashDir werden diese durch das Fenster gescrollt  und 
  276. ebenfalls selektiert. Hat man zuviele Dateien selektiert kann man 
  277. bei  immer noch gedrückter Maustaste in die Gegenrichtung  fahren 
  278. und  dadurch die zuletzt selektierten Dateien wieder  deselektie-
  279. ren.  Man kann sogar wieder über den zuerst selektierten  Eintrag 
  280. zurückfahren  und weitere Dateien in der anderen Richtung  selek-
  281. tieren; der zuerst selektierte Eintrag bleibt dabei selektiert.
  282. Auf  gleiche Weise kann man bereits selektierte Dateien  deselek-
  283. tieren.  Die jeweilige Funktion (Selektion/Deselektion) ist dabei 
  284. vom Status des zuerst angeklickten Eintrags abhängig.  Zur  Übung 
  285. kann man ruhig mit dieser Funktion experimentieren; solange keine 
  286. Löschfunktion (s.  Löschdialog / Löschfunktionen) ausgelöst  wird 
  287. kann nichts passieren.
  288. Alle Selektionen verlieren ihre Gültigkeit,  nachdem eine  Lösch-
  289. funktion (s.  Löschdialog / Löschfunktionen) ausgelöst wurde oder 
  290. wenn der Löschdialog mittels des 'Ausgang'-Knopfes (s.  Löschdia-
  291. log / Ausgang) verlassen wird.
  292. Im  Dateiauswahlfenster werden maximal 50 Dateien  angezeigt.  Im 
  293. allgemeinen sollte diese Anzahl ausreichen;  wenn man mehr als 50 
  294. Dateien im TrashDir hat,  scheint es an der Zeit, mal wieder auf-
  295. zuräumen.
  296.  
  297.  
  298. 3.1.2.3 TRASH.CPX: Löschdialog / Ausgang
  299.  
  300. Wird  der  Knopf  'Ausgang' angeklickt  gelangt  man  zurück  zum 
  301. Hauptdialog von TRASH.CPX (s. Bedienung Hauptdialog).
  302.  
  303.  
  304. 3.2 Bedienung von TRASH.PRG
  305.  
  306. TRASH.PRG hat keine eigentlichen Bedienungselemente.  Es ist  als 
  307. AUTO-Ordner-Anwendung konzipiert.  Da es nicht auf den  Zeitpunkt 
  308. der  Installation ankommt und TRASH.PRG ein  reines  TOS-Programm 
  309. ist,  kann  es auch vom Desktop aus gestartet werden.  Es  sollte 
  310. dann  jedoch in TRASH.TOS umbenannt werden.  Unter der  Betriebs-
  311. systemerweiterung MiNT muß TRASH.PRG nach MiNT gestartet  werden, 
  312. also z.B. aus MINT.CNF heraus.
  313. TRASH.PRG  versucht,  einen residenten Treiber für  einen  'leer-
  314. baren' Papierkorb zu installieren; dabei geben Meldungen Auskunft 
  315. über den Stand der Dinge.
  316. Was TRASH.PRG macht ist im Abschnitt 'Internes' angegeben.
  317.  
  318.  
  319. 3.2.1 TRASH.PRG: Meldungen
  320.  
  321. TRASH.PRG  gibt während des Programmlaufs Meldungen auf dem  TOS-
  322. Bildschirm aus.
  323. Zunächst  installiert  TRASH.PRG einen Cookie im  Cookie-Jar  (s. 
  324. Internes).  Tritt dabei ein Fehler auf,  wird eine  entsprechende 
  325. Meldung ausgegeben und das Programm abgebrochen.  TRASH.PRG  ver-
  326. bleibt dann nicht resident im Speicher.
  327. Anschließend  installiert  TRASH.PRG den Treiber für  den  'leer-
  328. baren' Papierkorb.  Die erfolgreiche Installation wird  gemeldet. 
  329. Der 'leerbare' Papierkorb ist zunächst  ausgeschaltet,  d.h.  der 
  330. Papierkorb  auf dem Dektop verhält sich normal.  Die  Papierkorb-
  331. Funktion kann von TRASH.CPX aus konfiguriert werden (s. dort).
  332. Falls  der  Treiber installiert werden  konnte  bleibt  TRASH.PRG 
  333. resident im Speicher.
  334.  
  335.  
  336. 3.2.2 TRASH.PRG: Internes
  337.  
  338. Für  Programmierer  oder Interessierte wird in  diesem  Abschnitt 
  339. ausgeführt, wie sich TRASH.PRG ins System einklinkt.
  340. TRASH.PRG  versucht  nach dem Start einen  Cookie  im  Cookie-Jar 
  341. anzulegen.  Dazu  wird  überprüft,  ob bereits ein  Jar  angelegt 
  342. wurde;  wenn  nicht legt TRASH.PRG einen Jar für acht Cookies  an 
  343. und  installiert eine Routine im resvector,  die bei einem  Reset 
  344. den Cookie-Jar deinstalliert (für TOS 1.xx erforderlich).
  345. Existiert bereits ein Jar,  wird untersucht, ob TRASH.PRG bereits 
  346. installiert wurde;  in diesem Fall wird das Programm  abgebrochen 
  347. und  bleibt  selbstverständlich nicht nochmal  im  Speicher.  Ist 
  348. TRASH.PRG noch nicht installiert, wird ein neuer Cookie angelegt; 
  349. ist der aktuelle Jar voll, legt TRASH.PRG einen größeren an.
  350. Wenn  ein  Cookie angelegt werden kann,  hat dieser  die  Kennung 
  351. (Magic)  "MZTR"  (0x4D5A5452L).  Der  Wert  (Value)  des  Cookies 
  352. enthält   einen  Pointer  auf  die  zentrale  Datenstruktur   von 
  353. TRASH.PRG:
  354.  
  355.      typedef struct
  356.      {
  357.           int   trash_status;
  358.           char  trash_dir[128];
  359.           int   trash_version;
  360.      } TRASH_INFO;
  361.  
  362. Die Bedeutung der einzelnen Komponenten:
  363.  
  364.   trash_status:   (R/W)  0 = Dateien löschen, 1 = verschieben
  365.   trash_dir:      (R/W)  TrashDir-Pfad mit Laufwerk und
  366.                          abschließendem Backslash
  367.   trash_version:  (R/O)  hex-Byte-Angabe der Version
  368.                          1.Byte Hauptrev. / 2.Byte Unterrev.
  369.  
  370. Nach dem Anlegen des Cookies verbiegt TRASH.PRG den TRAP#1-Vektor 
  371. (GEMDOS)  auf  den  Papierkorb-Treiber.  Das  XBRA-Protokoll  ist 
  372. implementiert; die XBRA-ID lautet "MZTR".
  373. Der Treiber fängt,  wenn er aktiviert wurde, Ddelete()-Aufrufe ab 
  374. und verschiebt die entsprechende Datei ins TrashDir. Dabei können 
  375. mehrere  Fehler  auftreten,  die  im  folgenden  näher  erläutert 
  376. werden:
  377. Zunächst wird geprüft, ob die betreffende Datei überhaupt vorhan-
  378. den ist;  wenn nicht,  wird an dieser Stelle der Fehlercode '-33' 
  379. zurückgeliefert.
  380. Danach  wird  geprüft,  ob die Datei den 'nur  lesen'-Status  hat 
  381. (Fehlercode '-36').  Anschließend wird per Malloc() Speicher  zur 
  382. Aufnahme  der Datei angefordert.  Reicht der Speicher nicht  aus, 
  383. wird ebenfalls ein Fehler gemeldet ('-39').
  384. Dann  wird  die Datei in  den  Speicher  eingelesen.  Auftretende 
  385. Fehler  werden mit dem entsprechenden Fehlercode  gemeldet.  Wenn 
  386. die Datei eingelesen wurde, wird sie ins TrashDir zurückgeschrie-
  387. ben und danach wird der Speicher wieder  freigegeben.  Eventuelle 
  388. Fehler werden wie beschrieben gemeldet.
  389. In  der  aktuellen Version von TRASH.PRG (V 01.05)  ist  es  kein 
  390. Fehler,  wenn  bereits  eine Datei gleichen  Namens  im  TrashDir 
  391. existiert; diese wird dann von der aktuellen Datei überschrieben. 
  392. Diesem  Verhalten  liegt die Philosophie zugrunde,  daß  es  aus-
  393. reicht, jeweils die letzte gelöschte Version einer Datei für eine 
  394. eventuelle  Restaurierung vorzuhalten.  Außerdem würde sonst  das 
  395. TrashDir unter Umständen sehr schnell anwachsen.
  396. Schließlich wird die Datei am Ursprungsort gelöscht.
  397.  
  398. Nachdem die Installation abgeschlossen ist,  verbleibt  TRASH.PRG 
  399. komplett im Speicher (mittels Ptermres).
  400. TRASH.PRG  wurde  vollständig  in  Assembler  geschrieben   (Pure 
  401. Assembler, ASH) und TRASH.CPX in PureC (auch ASH).
  402.  
  403.  
  404. 4. Copyright und Haftungsausschluß
  405.  
  406. TRASH.CPX und TRASH.PRG wurden entwickelt von
  407.  
  408.           Michael Zuhl
  409.           Transvaalstr. 16
  410.           1000 Berlin 65
  411.  
  412. Einige Anregungen, Ideen und Tricks wurden folgenden Quellen ent-
  413. nommen:
  414.  
  415. - CPX-Programmierung:
  416.     "CPX - Dem variablen Kontrollfeld auf der Spur", Serie in
  417.     ST-Computer 3-5/91 + 9/91, Uwe Hax und Oliver Scholz
  418.  
  419. - Cookiejar-Prinzip:
  420.     "STee-Gebäck - Das Cookie-Jar-Prinzip", in
  421.     ST-Computer 12/90, Rolf Kotzian
  422.     "Vorhang auf für die Keksdose", in
  423.     ST-Magazin 3/90, Julian F. Reschke
  424.  
  425. - XBRA-Protokoll und überhaupt:
  426.     Atari ST Profibuch, Jankowski/Rabich/Reschke,
  427.     SYBEX-Verlag, 10. Auflage 1991
  428.  
  429.  
  430. Die  CPX-Module der Utility-Serie von mz'91 (also auch  TRASH.CPX 
  431. und  TRASH.PRG)  sind  Freeware,  d.h.  sie  dürfen  kopiert  und 
  432. weitergegeben werden,  solange dies nicht kommerziell  geschieht; 
  433. davon  ausgenommen ist lediglich die Verbreitung über  PD-Disket-
  434. ten, solange diese gegen einen geringen Unkostenbeitrag abgegeben 
  435. werden.
  436.  
  437. Obwohl  bei  der  Programmierung alle Sorgfalt  geübt  wurde  und 
  438. TRASH.CPX und TRASH.PRG bei mir fehlerfrei laufen (s.  Einschrän-
  439. kung im Farbbetrieb unter 'Beschreibung von TRASH.CPX'), kann ich 
  440. keinerlei Garantie oder Haftung übernehmen, weder für die angege-
  441. benen Funktionen noch für irgendwelche eventuell aus dem Gebrauch 
  442. dieser  Programme entstehenden Folgeschäden.  Der Einsatz  dieser 
  443. Programme erfolgt ausschließlich auf eigenes Risiko.
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453. TRASH.CPX  V01.05
  454. TRASH.PRG  V01.05
  455. 10.09.92  mz'91
  456.  
  457.